Vignettes

This pull request is the first of multiple requests to merge vignettes into mampf. While most major features have been implemented, they still lack quality of life and a usable let alone pretty user interface.

Usage

The edit view of a questionnaire lists all slides (by position) and info slides (by title). One can edit a certain slide by clicking on the link, as well as create slides.

A normal slide is part of the linear progression of the questionnaire and can optionally include a question. Question types include text answers, multiple choice answers and a Likert scale. A slide can reference multiple info slides. To select multiple info slides hold ctrl.

An info slide can be referenced by a slide and contains additional information about the slide. This information can be accessed by a user filling out the questionnaire. Each info slide has an icon used as an image for the button that displays the info slide. If this icon is not set, then the title is used.

Additional Features

Statistics

One major feature of questionnaires is the tracking of additional statistics. For each answer the following stats are tracked:

• Time spent on the main slide
• Time spent on each info slide (in json format)
• Times each info slide was accessed (in json format)
• Answers given

To access these statistics, one can download them in the edit view of a questionnaire as a .csv file.

Unfinished answers

If a user starts filling out a questionnaire but does not finish, their progress is saved. When they return to the questionnaire, they will resume from their last position. This is also used to check that a user can't "cheat" by just setting the position value in the url (e.g /take?position=4)

Known bugs

• A video is not properly displayed in the edit view of a slide when accessed again.
• Error messages are not displayed properly

For reviewers

This feature is limited to very few people for the beginning. Especially the creation of vignettes will be limited to 2 or 3 people. Also the code is for the most part completely disconnected from the codebase. Therefore we may afford some imperfection in the beginning of the release.
Goal for release is the start of the new semester in April 2025.

To-Do's

Essentials

• Number question type
• Make position of slide editable
• UI Elements to delete slides and questionnaires
• Think of better way of displaying all slides in edit view
• Make questionnaires part of courses
• Support for multiple languages
• Make UI pretty (Support here is of course much appreciated)
• Limit feature to create Questionnaire to certain users
• Proper error messages

Nice to have

• Tests
• Make a chain of questionnaires (so user can only access one questionnaire after the previous was completed)
• Add feature to scale images in trix editor
• Replace trix editor with more powerful